home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Skunkware 5
/
Skunkware 5.iso
/
man
/
cat.1
/
xmcd.1
< prev
next >
Wrap
Text File
|
1995-07-25
|
22KB
|
463 lines
XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111))))
NNNNAAAAMMMMEEEE
xmcd - CD digital audio player utility for X11/Motif
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
xxxxmmmmccccdddd [_t_o_o_l_k_i_t_o_p_t_i_o_n ...] [-_d_e_v _d_e_v_i_c_e] [-_d_b_d_i_r _p_a_t_h] [-
_d_e_b_u_g]
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_X_m_c_d is a program that allows the use of the CD-ROM drive as
a full-featured stereo compact-disc player for the X window
system.
Most of the features found on real CD players are available
in _x_m_c_d, such as shuffle and repeat, track programming
functions, and a numeric keypad for direct track access.
Additional functions include sample play, A to B segment
play, volume control, etc.
A built-in CD database feature allows the CD artist/title
and track titles, and other associated general purpose text
to be maintained and loaded as the program is started or
when a CD is inserted.
Full feature-specific pop-up help is available for all
controls, indicators, text input fields, and lists.
On systems with more than one CD-ROM drive, multiple
invocations of _x_m_c_d can be used to operate each drive
independently.
_X_m_c_d is designed to be easy to use, as the main window is
purposely made to resemble a real CD player front panel.
All other pop-up windows are also designed to be as
intuitive as possible. Moreover, while the use of a mouse
is natural with _x_m_c_d, all functionality can also be operated
via the keyboard. This is in conformance to the guidelines
published in the _O_S_F/_M_o_t_i_f _S_t_y_l_e _G_u_i_d_e from the Open
Software Foundation.
The internal architecture of _x_m_c_d is designed from the start
to be easily portable to many operating system platforms,
and adaptable to the myriad of CD-ROM drives available.
OOOOPPPPTTTTIIIIOOOONNNNSSSS
All standard _X_t _I_n_t_r_i_n_s_i_c_s toolkit options are supported.
In addition, _x_m_c_d supports the following options:
-_d_e_v _d_e_v_i_c_e
Specifies the path name to the raw CD-ROM device. If
Page 1 (printed 7/3/94)
XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111))))
this option is not used, the default device to be used
is the first drive set up with the _x_m_c_d configuration
program (See below).
-_d_b_d_i_r _l_i_s_t
Specifies a colon-separated list of category
directories where the CD database files are to be kept.
See the description for XXXXMMMMCCCCDDDD____DDDDBBBBPPPPAAAATTTTHHHH in the ENVIRONMENT
section below.
-_d_e_b_u_g
Causes verbose debugging diagnostics to be printed on
_s_t_d_e_r_r.
XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
_X_m_c_d has many adjustable X resources to customize its look
and feel, as well as its behavior. Notably, the colors of
virtually every feature on _x_m_c_d's windows can be changed, as
well as the text fonts. All text labels can also be changed
(for example, to another language).
There are too many resources to list here, but the resource
names and their defaults (plus descriptive comments) can be
found in the LLLLIIIIBBBBDDDDIIIIRRRR/_a_p_p-_d_e_f_a_u_l_t_s/_X_M_c_d file (where LIBDIR is
typically /_u_s_r/_l_i_b/_X_1_1). It is not recommended that you
change values in the LLLLIIIIBBBBDDDDIIIIRRRR/_a_p_p-_d_e_f_a_u_l_t_s/_X_M_c_d file, unless
you want the changes to be forced upon all users of _x_m_c_d on
the system. Instead, make a copy of this file, change the
copy as you see fit, then place it in your home directory.
Your custom resource settings will then override the
defaults when _x_m_c_d is subsequently started. Alternatively,
you may also place specific resources you wish to override
in the ._X_d_e_f_a_u_l_t_s file in your home directory.
DDDDEEEEVVVVIIIICCCCEEEE CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN
The X resources described in the previous section affect the
general appearance and behavior of _x_m_c_d. There are
additional configurable parameters that must vary on a per-
drive basis. For example, in some cases _x_m_c_d must operate
the drive differently depending upon the brand and model of
the drive. Thus, there must be a separate configuration
file for these parameters _p_e_r-_d_e_v_i_c_e. The default file is
XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_o_n_f_i_g/DDDDEEEEVVVVIIIICCCCEEEE (where XMCDLIB is typically
/_u_s_r/_l_i_b/_X_1_1/_x_m_c_d and DEVICE is the base name of the raw
device special file for the CD-ROM drive ; e.g.,
/_u_s_r/_l_i_b/_X_1_1/_x_m_c_d/_c_o_n_f_i_g/_r_c_d_0). A configuration program
XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_o_n_f_i_g/_c_o_n_f_i_g_u_r_e._s_h is provided to make maintaining
the device-specific configuration file easy (Note: on SCO
systems the configuration program can also be invoked as
"_m_k_d_e_v _x_m_c_d").
Page 2 (printed 7/3/94)
XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111))))
You should always use the configuration program to set the
device-specific parameters when installing _x_m_c_d for the
first time, or when the CD-ROM hardware configuration has
changed. If this is not done then _x_m_c_d will probably not
operate correctly with your CD-ROM drive.
WWWWAAAARRRRNNNNIIIINNNNGGGG:::: If _x_m_c_d is not correctly configured, you may cause
_x_m_c_d to deliver commands that are not supported by your CD-
ROM drive. Under some environments this may lead to system
hang or crash.
You can override some of the device-specific configuration
parameters by adding your own configuration files. _X_m_c_d
will also look in HHHHOOOOMMMMEEEE/._x_m_c_d_c_f_g/DDDDEEEEVVVVIIIICCCCEEEE file for device-
specific parameters (where HOME is your home directory and
DEVICE is as specified above). Parameters found in this
file will override the system defaults (except those
parameters that cannot be overridden; see the comments in
the XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_o_n_f_i_g/_d_e_v._c_o_n_f_i_g for details).
UUUUSSSSIIIINNNNGGGG XXXXMMMMCCCCDDDD
The basic functions of _x_m_c_d are designed to operate the same
way as on a real stereo CD player. The pictorial symbols
used on the main window buttons are intended to illustrate
the function in a non-language-specific manner. You can
also change all main window buttons to display a text label
instead of the pictorial symbols, by clicking the ddddiiiissssppppllllaaaayyyy
check-box button (the "A" symbol enclosed in a box) located
at the upper left hand corner of the main window.
The CD database and track programming functions are operated
via the CD Database/Track Program Editor pop-up subwindow.
You activate the subwindow by pressing the ccccddddddddbbbb////pppprrrroooogggg button
(file cabinet symbol) on the main window (See "CD DATABASE"
below).
There will not be a per-item description of all the
features, because full on-line help is available (See
"ONLINE HELP" below).
OOOONNNNLLLLIIIINNNNEEEE HHHHEEEELLLLPPPP
For general information about _x_m_c_d, click the hhhheeeellllpppp (question
mark symbol) button on the _x_m_c_d main window. You can also
get specific help information about each button, control,
indicator, text entry area, selection list by positioning
the mouse cursor over the desired item, then clicking the
third mouse button. A pop-up window will appear, containing
the relevant help text.
Page 3 (printed 7/3/94)
XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111))))
TTTTRRRRAAAACCCCKKKK PPPPRRRROOOOGGGGRRRRAAAAMMMMMMMMIIIINNNNGGGG
You can program _x_m_c_d to play only certain tracks, in a
custom sequence. To do so, invoke the CD Database window
(by pressing the ccccddddddddbbbb////pppprrrroooogggg button on the main window).
Select the desired track by clicking on the entry in the
TTTTrrrraaaacccckkkk lllliiiisssstttt,,,, and click the AAAAdddddddd button to add to the play
sequence. Notice that the track number appears in the PPPPllllaaaayyyy
sssseeeeqqqquuuueeeennnncccceeee text field. You can also type the track numbers,
separated with commas, directly in the PPPPllllaaaayyyy sssseeeeqqqquuuueeeennnncccceeee field.
Repeat until all desired tracks have been entered, then
press the Track Program PPPPllllaaaayyyy button in the CD Database
window (not the PPPPllllaaaayyyy////PPPPaaaauuuusssseeee button on the main window) to
start the program play.
During program play, the pppprrrroooogggg indicator in the main window
display area "illuminates".
CCCCDDDD DDDDAAAATTTTAAAABBBBAAAASSSSEEEE
The CD Database feature of _x_m_c_d allows you to enter the CD
artist/title, track titles, other free-form text (such as
band information, lyrics, etc.) associated with the disc and
tracks, and a track play program. After this information is
typed in and saved to a database file, it will automatically
appear on the _x_m_c_d CD Database window when the same CD is
inserted again.
You must perform a "save" operation (press the SSSSaaaavvvveeee button)
after typing in the database information before ejecting the
CD or exiting, or the information will be lost. If this is
the first time this CD database entry is being stored, you
will be asked to select a category (rock, classical, jazz,
etc.) under which to classify the CD. The category is used
by _x_m_c_d to determine the actual directory in the filesystem
to write the database file.
Once the database information has been saved, the ccccddddddddbbbb
indicator on the _x_m_c_d main window display area
"illuminates".
You must type the CD information into the database because
the CD's table of contents (TOC) contains only the number of
tracks and the starting address of each track, but not the
actual disc and track titles.
The CD database window should prove to be intuitive to use.
You may use the on-line help system to obtain specific help
information about the various buttons and items.
The CD database information is stored in text files, one per
CD, in a designated directory (category). The path of this
directory is XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b/CCCCAAAATTTTEEEEGGGGOOOORRRRYYYY, where XMCDLIB is the
Page 4 (printed 7/3/94)
XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111))))
directory specified by the XMcd.libdir resource, and
CATEGORY is the category name selected when SSSSaaaavvvveeee is
performed. The list of categories used is specified by the
XMcd.dbdir resource. In addition, if the XMcd.dbdir
resource contains full directory path names, then these will
be used without prefixing the XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b.
You may view the list of directories that _x_m_c_d will search
for CD database files by pressing the AAAAbbbboooouuuutttt............ button and
viewing the pop-up information window.
The file name of each CD database entry is a hexadecimal
representation of a special "magic" number computed by _x_m_c_d
based on the number of tracks, track timings, and other
available information about this CD. This method is used
because there is no reliable unique CD identifier to be
found on the CD itself (the CD standard allows for a
readable IPC/barcode but very few CDs actually contain such
information).
Since different pressings of the same CD may sometimes
contain slightly different track timings, the resultant
magic number computed by _x_m_c_d on these CDs will be
different. Thus, if you load a CD that is not the same one
that a CD database entry was created with (but is actually
the same CD title), _x_m_c_d may not recognize it and display
the database information automatically when you insert the
CD. In this event, you can search the CD database and find
the appropriate entry, and establish a "link" to it. To do
so, press the LLLLiiiinnnnkkkk button, and select the appropriate
category on the popup window. _X_m_c_d will then present
another pop-up window containing a list of all CD database
entries in the specified category (that has the same number
of tracks as the currently inserted disc). Select the
appropriate entry and a link will be made in the CD
database.
The LLLLiiiinnnnkkkk feature alleviates the need to type in CD database
information again and avoids duplicate CD database entries.
In very rare occasions it is possible that the magic number
of a CD conflicts with that of another. This is a problem
that will be addressed in a future release of _x_m_c_d.
EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
Several environment variables are currently recognized by
_x_m_c_d, and are described as follows:
XXXXMMMMCCCCDDDD____LLLLIIIIBBBBDDDDIIIIRRRR
This is used to override the XMcd.libdir resource.
This parameter is the directory path under which _x_m_c_d'_s
Page 5 (printed 7/3/94)
XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111))))
configuration files, help files, and CD database files
are located. The default value of XMCD_LIBDIR on most
systems is /_u_s_r/_l_i_b/_X_1_1/_x_m_c_d.
XXXXMMMMCCCCDDDD____DDDDBBBBPPPPAAAATTTTHHHH
This is used to override the XMcd.dbdir resource, which
is a list of CD database category directories to be
used under XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b (where XMCDLIB is the directory
root specified by the XMcd.libdir resource or the
XMCD_LIBDIR environment variable). You may also use
the ----ddddbbbbddddiiiirrrr command line option, which has the highest
precedence. An example of a XMCD_DBPATH string is as
follows (note the colon separators):
rrrroooocccckkkk::::ccccllllaaaassssssssiiiiccccaaaallll::::jjjjaaaazzzzzzzz::::nnnneeeewwwwaaaaggggeeee::::ssssoooouuuunnnnddddttttrrrraaaacccckkkk::::mmmmiiiisssscccc
This string will cause _x_m_c_d to search the following
directories for CD database files:
XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b/_r_o_c_k
XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b/_c_l_a_s_s_i_c_a_l
XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b/_j_a_z_z
etc.
You may also specify absolute path names in the
XMCD_DBPATH entries. Example:
rrrroooocccckkkk::::ccccllllaaaassssssssiiiiccccaaaallll::::////uuuussssrrrr////jjjjoooohhhhnnnn////iiiinnnndddduuuussssttttrrrriiiiaaaallll::::////uuuussssrrrr////jjjjoooohhhhnnnn////tttteeeecccchhhhnnnnoooo
HHHHOOOOMMMMEEEE This is used to determine your home directory. If HOME
is not defined, then _x_m_c_d tries to obtain it from the
/_e_t_c/_p_a_s_s_w_d file. The home directory path is used by
_x_m_c_d to locate the ._x_m_c_d_c_f_g directory.
NNNNOOOOTTTTEEEESSSS
Not all CD-ROM drives support all features that appear on
_x_m_c_d. For example, most SCSI-1 drives do not support a
software-driven volume control. On these drives the _x_m_c_d
volume control slider may have no effect, or in some cases
it is made to function as a mute control (i.e., it will snap
to the full-off or full-on positions only). Similarly, the
ccccaaaaddddddddyyyy lllloooocccckkkk, eeeejjjjeeeecccctttt and iiiinnnnddddeeeexxxx sssseeeeaaaarrrrcccchhhh buttons found on _x_m_c_d may
not have any effect on drives that do not support the
appropriate functionality.
FFFFIIIILLLLEEEESSSS
$HOME/.xmcdcfg/*
XMCDLIB/cddb/*
XMCDLIB/config/configure.sh
XMCDLIB/config/dev.config
Page 6 (printed 7/3/94)
XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111))))
XMCDLIB/config/.tbl/*
XMCDLIB/config/*
XMCDLIB/help/*
LIBDIR/app-defaults/XMcd
BINDIR/xmcd
MANDIR/xmcd.1
SSSSEEEEEEEE AAAALLLLSSSSOOOO
wm2xmcd(1), X(1).
AAAAUUUUTTTTHHHHOOOORRRR
Ti Kan (_t_i@_a_m_b._o_r_g)
AMB Research Laboratories, Sunnyvale, CA, U.S.A.
_X_m_c_d also contains code contributed by several dedicated
individuals. See the README file in the _x_m_c_d distribution
for information.
Comments, suggestions, and bug reports are always welcome.
Page 7 (printed 7/3/94)